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Congratulations on your purchase of the Universal Dock/Extension Board. This device 
is designed to fit in the Cartridge port on the right side of your TS2068. The board 
has the maximum possible flexibility built into it. Features this device offers are 
listed below. Following that are recommended operating procedures and software 
techniques you can use to make good use of this NVM memory. 


Read the board installation/removal instructions and precautions before plugging this 
memory into your TS2068. 


HARDWARE FEATURES 


* 32K Non-Volatile Ram can reside in either the Cartridge Bank or the EXROM Bank. 
* Battery Backup prevents data loss on power failure. 

The board can run under 100% battery power or draw power from the 2068 while 
the 2068 is powered up. 

* Write protect switch prevents accidental data loss during program development. 
Chunk specification can be easily modified even after data has been stored. 

The memory can mask the EXROM or contain LROS and AROS programs. 


* 


* Ok 
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NVM INSTALLATION AND REMOVAL 


Remove the paper circuit breaker from between the battery arm and the battery. Pull 
out the small jumper wire which is inserted in the socket found to the left of the 
battery. A wire tie has been twisted around this jumper to make its removal easy. 
Don't lose this jumper. You may wish to re-insert it later. ‘ 


To install the board in the computer, open the TCC door. Discharge your fingers on 
some metallic object (but don't shuffle across the carpet to use the door knob). 

Place the NVM board in the dock area and apply thumb pressure directly to the center 
of the edge of the board. DON'T press on the ram chips during installation. The small 
feet on the bottom of the board will support it at the proper height, but the keyway 
must be aligned with the slot before the board will seat properly in the dock 
connector. 


To remove the board, be sure that the write protect switch is on the "PR" side, and 
discharge your fingers again. Place your right thumb on the edge of the computer in 
front of the CAPS SHIFT key. With your index and second index finger of the right 
hand on each side of the white stripe on the first chip, pull evenly back until the 
board snaps loose. 


These white stripes are painted on the chips to show you where NOT to place your 
fingers when you pull the board out from the machine. There are soldered jumper wires 
in the area between the white stripes. They actually distinguish each RAM chip from 
the others. 


**Avoid pressing on the wires located by the white stripes** 


This board is conformally coated, or painted with a special urethane coating that can 
withstand well in excess of 2000 volts of static discharge from your fingertips. 

DON'T TEST IT!! We have done our best to give your data maximum protection against 
electrical accidents, but for added insurance, ground yourself BEFORE you pick up the 
board. If you live in a static filled environment, touch a nearby metal object such 

as a lamp before you touch the memory board. A static discharge will not harm you, 
but it could damage the memory. Three small feet under the board prevent it from 
touching a table top or shelf when it is stored outside the computer thereby 

providing further protection from static or an accidental short circuit. 


IMPORTANT!!! 


A small piece of insulating tape is placed on top of the battery arm to prevent the arm 
from coming in contact with the conductive coating on the inside of the TS2068 case. 
Do not remove this tape when you plug the memory into the computer. If you do, the 
battery will short circuit and become discharged after just a few hours of use. Before 
you plug the memory into the computer, always check that the tape is covering the 
battery arm and that it is in good condition. Replace with any non-conducting mater- 
ial such as black electrical tape whenever it becomes necessary. 


HARDWARE DESCRIPTION 
OF THE NVM MEMORY BOARD 


Static RAM chips (#6264-LP15) supply the memory for this board. They are designed as 
ag Be 8 bits, or 8K bytes. Four chips are stacked two high, giving a total of 32K 


There are two switches on the left side of the board. The first, marked WR and PR, is 

a write protect switch. When the switch is on the PR side, your data is protected. 

You cannot overwrite what is already in your ram (similar to EPROMS). When the switch 
is in the WR mode, then the board becomes RAM and memory locations can be modified. 


The second switch is the bank select switch. It is marked EX and DK, for EXROM bank 
and Dock (Cartridge) bank. This switch allows you to map your ram in either bank and 
change back and forth between banks at any time. When you use this switch to change 
banks, no RAM actually changes values. What does change is the way the computer sees 
the memory that's plugged in. You alter the board's configuration, not the memory 
itself. 


Normally you will work with the board switched to the DOCK configuration, but if you 
have other devices which reside in the dock memory area, you can let the NVM board 
stay in the EXROM bank. At present, there is no program which will conflict with this 
approach. 


Ahead of the switches, you will find a chip marked 74xx138, where the xx stands for 
LS, HC or SC. For our purposes, all of these chip types are synonomous. This device 
allows us to choose the chunks (groups of 8K bytes) in which we would like our memory 
to reside. This is done by way of the four rows of headers which are located just 
ahead of the LS138. The eight pins in each row represent one 8K chunk of address 
space. Counting pins from left to right (0-7) tells which chunk each pin addresses. 


The corresponding pins of the two outside rows of headers are connected together 
(front to back). Each outside pin is capable of selecting one chunk. Each of the two 
inside rows are connected to one of the chip select pins of the two bottom ram chips. 
The proper chunk is selected (for the two bottom chips) by jumping the inside row to 
the outside row. Since the two top ram chips have no direct connection to the board, 
jumper wires from each of their chip select lines connect to the jumper area in order 
to access them. By looking at these wires, you can see that these, too, are connected 
to one of the outside rows. 


The two bottom memory chips are mapped to chunk 5 and chunk 6. The top chips are 
mapped to chunk 4 and chunk 7. By changing the connectors on the chunk select pins, 
you can alter the memory chip addresses to any chunk you want. Since the first four 
chunks are used by the system for various purposes, proper access of these chunks can 
be tricky. They are available to the adventuresome, however. 


in front of the jumper area, you will find 8 diodes. These diodes are necessary to 

defeat the lack of decoding (inside your 2068) while in the EXROM bank. They allow 

you to access your NVM while in that bank. If you desire, you may copy the contents 

of the EXROM into NVM and deselect the internal EXROM entirely. The single jumper in 
front of the diodes allows this. Without this jumper in place, the EXROM in the 
computer will function normally. In fact, this jumper must be removed for most set 

ups. If you would like to defeat the internal EXROM, copy its contents into high RAM 

of the NMV, shut down your machine, rejumper that high chunk down to chunk 0 and 
install the internal EXROM disable jumper. 


Just ahead of the EXROM disable jumper are the power diodes. These diodes separate 
the 5 volt power of the 2068 from the battery power on the board. The 6264 chips 
require at least 2.2 volts in order to function. The battery will provide 2.8 to 3.4 
volts. There is a slight drop in voltage across the diode. The 6264 chips should see 
about - volts for the duration of the life of the battery (while under battery 
power). 


The 2068 Chunk/Bank memory map looks like this: 


HOME DOCK EXROM ___ 

' CHUNK 0 ROM LROS EXROM 

0-8K 

CHUNK | ROM LROS OPEN 

8-16K 

CHUNK 2 VIDEO LROS OPEN 

16-24K 

CHUNK 3 VARS/SYS. OPEN | OPEN 

24-32K BASIC 

CHUNK & RAM AROS OPEN 

32-40K 

CHUNK 5 RAM AROS OPEN 

40-43K 

CHUNK 6 RAM AROS OPEN 

48-56K 

CHUNK 7 RAM AROS OPEN 

56-64K UDG 


The NVM configurations available to you are the AROS, LROS and open areas. A problem 
with using the areas below chunk 4 (chunks 0 to 3) is that the BASIC operating system | 
may also try to use those chunks while you are. Every time the video screen is A 
updated, the 2068 assumes that chunks 2 and 3 are in home ram. Since the video 
interrupt is all powerful (it stops the Z80 cpu until it has accessed the ram and 

created the picture), you must be quick if you desire to use these areas. 


This finally brings us to the battery--most important single component of the board. 
The first tffing you should do is remove the paper which breaks contact between it and 
the battery arm and LEAVE IT ALONE. Don't remove_and reinstall the battery 
frequently. It has been calculated that under normal conditions the battery will 
outlive all of us! The BR2325 lithium cell has a capacity of 160 milliAmp hours. This 
means that the battery would last for 1 hour if it were to be subjected to a drain of 
160 milliAmps. (This is, by the way, equal to the drain of a 64K dynamic ram pack.) 
In standby mode (the computer turned off or the NVM board unplugged) the NVM board 
draws approximately 200 nanoAmps. That is 200 BILLIONTHS of an amp! This is a 
calculated number from the extrapolation of a log graph. I do not have an ammeter 
that will measure below 1 microAmp! 


Anyway, this means that the battery will last for 150 years!! However, if we take the 
manufacturers worst case spec. for the 6264 chips, the battery will last for 417 

days. Remember, though, the battery is used only when the board is unplugged or when 
the computer is turned off. When power from the ‘computer is supplied to the board, 


the battery is not used. 


You may decide that you like to power the board by battery at all times and never 
draw 5 volts from the 2068. In this case the draw of about 50 microAmps would drain 
the battery in about 6 months of continuous use. 


You can measure the voltage on the battery with a Digital volt meter by measuring 
from the top of the battery to the right most trace on the edge connector, the ground 
line, which is in front of the LS122. When the battery reaches 2.7 Volts, you should 
consider purchasing a new battery. 


If you decide that it is absolutely necessary to "chop" power from the battery, then 
slide a piece of plastic or paper under the battery holder arm. If you constantly 
remove and reinstall the battery, then the holder will lose tension, which may cause 
intermittent or erratic operation. If this is a problem, then remove the battery and 
bend the + battery prong down to provide a more secure fit. You should never need a 
new battery, but if you do, Radio Shack is presently stocking several types. The 
battery need only be between 3 (recommended) and 5.3 volts. In lithium cells, the 
first two numbers signify the diameter of the cell (23 millimeters) and the last two 
signify the thickness (25 = 2.5 mm.). The thickness also determines the battery 
capacity. The holder will take 2016 to 2325 cells and still fit under the dock shelf 
of the computer. . 


TIPS and MISC. 


If you are having memory loss problems, take a minute to be sure the battery is 
properly seated and clean. Dust deposits may prevent a good connection between the 
holder arm and the battery. : 


Be sure to flip the write protect switch on during power down and keep it on if the 
board is removed from the machine. 


The LS138 and LS122 are not powered by the battery at all. If you decide to play with 
the board outside of the 2068, you will need to supply a smooth Svdc to both of these 


support chips. 


The jumper area and the switch tops are not conformally coated. Insure that you 
discharge any static buildup that you may have accumulated prior to flipping any 
switches. - 


Do not pull the 6264 RAM chips out of their sockets. You may have trouble reseating 
them because of the static proof coating. There is no circuitry to observe under 
these chips anyway. 


Although we have not tried it, by tacking a 100 mFd cap across the power and ground 
rails, you may be able to change the battery without loss of memory. You would have 
about 5 to 10 seconds. (Also consider precharging the capacitor to 3 volts prior to 
touching it to the power rail.) 


_ Do not remove the chunk select jumpers for extended periods of time. Unnecessary 
battery wear will result. If you plan to store the NVM or if you use it without the 
computer supplying power to it, battery life is greatly extended when these jumpers 
are left in place. 


On the same subject of extending battery life, do not leave the 32K memory plugged 
into the computer for long periods if the computer is turned off. Excessive battery 
‘wear in this situation will cause the battery to become discharged in about a week. 
Remember this rule: When you turn off the computer, unplug the memory board!! 


PROGRAMMING THE 32K NVM 


Before the finer points of using memory in the 32K extension are explained, let's 
backtrack a bit and think about a computer's memory in general. Memory to the 
computer is like a large notebook. Each page contains one number from 0-255. The 
computer is able to write a number down or look a number up. In order for the ; 
computer to access the notbook, each page is given an “address” or "page number" in 
addition to the value which can be stored. Thus, the machine can read the value on 
page 5000 or write the number 44 on page 32000. When you use the Basic PEEK and POKE © 
commands, such as POKE 32000,44 you tell the computer to write a "44" on page 32000. 


Built in to the Z80's microprocessor design is a limitation. The notebook can't be 
longer than 65,536 pages. In computer terms this means that the maximum amount of 
memory available to the computer at any one time is 65536 bytes (64K). You can't add 
more memory to extend the pages to say, 90K. 


£ 


BANKED MEMORY 


The Timex designers came up with a very clever way to get around this limitation 

called "BANKED MEMORY”. Using this technique, the TS2068 is capable of switching from 
one "bank" of 64K to another. This allows for greatly expanded memory capacity yet 

still maintains the 64K limit of the Z80's design because at no time does the Z80 see 
more than 64K of addressable memory. In the note book analogy, this is like having 

more than one note book. The computer can read the value on page 50000 of note book 
number 1 or it can read the value on page 28000 of note book number 2.. 


Built in to the TS2068 are provisions for 3 "banks" which can each hold a maximum of 
64K (It was intended that up to 256 banks would be available, but Timex’s demise put 
an end to that, at least for a while). These banks are named the HOME, the DOCK, and 
the EXROM. Each bank has an address just like individual bytes of memory. The HOME 
bank is number 255, the DOCK is number 0, and the EXROM is bank number 254. 


‘When you use the unexpanded 2068, you work mainly with the HOME bank: except when you 
save, load, verify, or merge with your tape recorder. These functions all exist in an 
"extra" bank in which only one 8K ROM is present, hence the name "EXROM", and hence 
the claim of 72K of memory in the 2068. You have 64K in the HOME bank plus 8K in the ~ 
EXROM. Cartridge software which fits under the door on the front of the computer is 

in actuality, a program which occupies memory in the DOCK bank. It is. important to 
remember that while the computer gives you the ability to use memory in these 

different banks, you can't do it unless you actually have the memory. It is not 

hiding in your computer waiting to be utilized. It is only by adding memory that bank 
switching functions become useful. 


BANKS, CHUNKS, and MEMORY SELECTION 


Each bank of 64K is further subdivided into a series of eight 8K "chunks" (8*8K=64K). 
This is like placing dividers every 8192 pages in each of our notebooks. The TS2063's 

bank switching facilities, in addition to letting you completely switch from one bank 

to another, also let you mix and match different chunks of two different banks. You 

can select combinations of the DOCK and HOME banks and the EXROM and HOME banks. 
Unfortunately, you cannot select combinations of the EXROM and DOCK banks. 


Chunk selection is carried out by outputting a value to the I/O port number 244, You 
can turn various chunks on or off by using the Basic command: OUT 244,xxx ("xxx" is 
the number calculated to turn on or off the desired chunks). You can also check which 
chunks are currently engaged by using the Basic command: PRINT IN 244, 


Here's how to determine the proper value to output to port 244. Since there are 8 
chunks in a 64K bank, the 8 bits of the number you output serve as "chunk switches". 
If a bit is 1, its corresponding chunk of the NVM board is turned on. If a bit is 0, 

its corresponding chunk of the HOME bank is turned on. For example, if you OUT 244, 


BIN 00000000. (or OUT 244,0) you will select all 8 chunks of. the HOME bank. If you 

enter OUT 244, BIN 10000000 (or OUT 244,128) you will turn on chunk 7 in the NVM 
board, and chunks 0-6 in the HOME bank. If you want to turn on all chunks of the NVM 
board, you would enter the command: OUT 244, BIN 11110000 (or OUT 244,240). Note that 
using the BIN function makes it quite easy to know which chunks of the NVM board you 
are turning on or off. The 1's represent the NVM board, the 0's represent the HOME 

bank. 


This method works when the memory board is configured for use in the DOCK bank. You 
can also flip the bank select switch on the board so you can use the memory in the 
EXROM bank. To enable chunks in the EXROM bank, you must also output a number to I/O 
port 255. Bit 7 of this port determines if a chunk selection you make (through port 

244) will be a combination of DOCK and HOME or EXROM and HOME. When bit 7 is a "1" 
the EXROM is selected. When bit 7 is "0" the DOCK is selected. Therefore, if you 
configure your NVM board as EXROM you select desired EXROM chunks of the board by 
first entering the command OUT 255, BIN 10000000 (or OUT 255,128). Then you OUT 244 
‘with the chunk selection you want. If you want to turn the EXROM off so that chunk 
selection refers back to the DOCK bank, you execute the Basic command OUT 255,0. 


Since other bits df port 255 specify other modes and functions on the computer, you 
may not always want to simply output a 128 because doing this will reset bits 0-6 
giving them the value of zero. To set just bit 7, use the Basic command: LET X=IN 255 
to find the current status of the port. Then add 128 to the value of X with the 
command, LET X=X+128, and send the new value back out to the port with OUT 255,xX. 


When you select a combination of active chunks in the DOCK/HOME or EXROM/HOME banks, 
it is like’ restructuring the notebook. At any given time, there is a maximum of 65536 

pages, but your chunks (divisions within the notebook) can be mixed. It is important 

to note that the Basic operating system is located in chunks 0, 1, 2, and 3 of the 

HOME bank. You never want to turn these off if you are working in Basic..It's a 

guaranteed crash if you do! 


SUMMARY OF BASIC COMMANDS TO 
SELECT BANK CHUNK COMBINATIONS 


To configure the NVM board as DOCK memory, flip the EX/DK switch to "DK". You then 
have four 8K chunks available to you. Any combination of them can be selected as 
"active" by outputting an appropriate value to port 244. Below are a few possible 
combinations. 


OUT 244,0 (or BIN 00000000) turns on the entire HOME Bank. 
OUT 244,128 (BIN 10000000) turns chunk 7 on in the dock. 
OUT 244,192 (BIN 11000000) turns on dock chunks 6 and 7. 
OUT 244,224 (BIN 11100000) turns on dock chunks 5, 6, 7.. 
OUT 244,240 (BIN 11110000) turns on dock chunks 4, 5, 6, 7. 


These commands define the memory the Z380 microprocessor sees. Bits of the value 
Sutput which are "1" specify 8K chunks of the DOCK bank. Bits which are "0" specify 
chunks of the HOME bank. 


Selecting or deselecting chunks does not alter values stored in memory. Chunks are 
simply "switched in" or "switched out". Do not output a number which will set any of 
the lower four bits to 1. Doing so will turn off your Basic ROM and you will crash 
the computer. 


You can check the "current Status" of your memory configuration by executing the 
Basic IN 244 command. This will result in a decimal number which when converted to 
binary will tell you which chunks are HOME and which are DOCK. 


To use this board as EXROM memory, switch the EX/DK switch to "EX". Then set bit 7 of 
port 255 to a value of I. This is done by adding 128 to whatever value is currently r 
found at the port. Selection of EXROM/HOME chunk combinations then follows the same 
rules shown above for DOCK configurations. 


The on-board battery will keep the contents of the NVM board alive even when you turn 
the computer off. It is a good and prudent practice, however, to set the Write 

Protect switch to "PR" before turning off the computer or before you execute the 

basic NEW command. 


EXAMPLES OF USING THE NVM 
BOARD IN BASIC PROGRAMS 


There are many ways you can use this extra memory. One very simple method is to use 
it strictly for data storage purposes and accessing the memory with PEEK and POKE 
commands. In the following listing, line 10 sets ramtop to just below the first byte 

of chunk 4. This gives you a total of 64K of memory above ramtop--32K in the HOME 
Bank and 32K in the DOCK. In addition, you have about 6000 bytes of memory in the 
HOME bank below ramtop for a basic program and variables. 


10 CLEAR 32767: LET $=32776: LET C=1 

20 INPUT "ENTER SOME TEXT";A$ 

30 GO SUB 9000 

40 INPUT "ENTER SOMETHING DIFFERENT";A$ 

50 LET C=0: GO SUB 9000 

60 PRINT "NOW RETRIEVING DATA FROM THE DOCK" 
70 LET C=1: GO SUB 9100: PRINT A$ 

80 PRINT: PRINT "DATA FROM THE HOME BANK IS..." 
90 LET C=0: GO SUB 9100: PRINT AS ° 
100 STOP 


9000 OUT 244,(240*C): POKE S,LEN A$ 
9010 FOR X=1 TO LEN A$ 
9020 POKE (S+X),CODE AS(X): NEXT X: RETURN 


9100 OUT 244,(240*C): LET AS="" 

9110 LET L=PEEK S 

9120 FOR X=S+1 TO S+L+i 

9130 LET A$=A$+CHRS PEEK X: NEXT X: RETURN 


The subroutine at 9000 writes the contents of A$ into memory. The first line (9000) 
selects which bank. The variable C holds either a | (DOCK) or a 0 (HOME) so the 
command OUT 244,(240*C) will result in 0 (240*0) if C=0 or 240 (240*1) if C=1. 


Once the chunk is selected, lines 9010-9020 use a FOR/NEXT loop to poke the codes of 
AS into their proper addresses. 


The subroutine at 9100 works the same way but the direction is reversed. Here, AS is 
filled with the characters found in memory. In both cases, it is necessary to 
determine the length of the string in question so that the FOR/NEXT loop will know 
when to stop. Address 32776 stores this length. 


RUNNING BASIC PROGRAMS FROM THE DOCK 


One big reason why the dock bank was engineered into the TS2068 was to make it 
possible to run cartridge software. Built into your computer's operating system is the 
ability to run BASIC programs from the Dock. The advantage of storing a program in the 
Dock bank is that memory in the Home bank which was ordinarily used to store the 
program is free to be used for variables. More data can thus be operated on by. the | 
computer. In addition, the time spent for loading the program from tape can be reduced 
considerably. You need only to load the variables--not the program! 


Timex's original intent was that programs stored in the dock bank would come on a ROM 
‘or EPROM, but there is nothing to prevent you from putting a program into the RAM of 
this memory board. In fact, a Dock program stored in RAM offers the advantage of being 
alterable. This is very helpful should you ever need to change the program in some 
way. The disadvantage of using RAM is that there's always a faint possibility that you 
could accidently erase the program. The write protect switch reduces the risk 
substantially, but: accidents can happen. Perhaps the best course to follow is to use 
both EPROMs and ram. You can write and debug the program very easily using the RAM. 
Then, when you're satisfied that everything is running perfectly, you can transfer the 
program over to an EPROM. If you use EPROMs alone, everytime you make a change, you 
must burn a new one. You must stap, erase your chip, then reprogram it. If you're like 
me, this might need to be done dozens (maybe even hundreds) of times. 


HOW TIMEX BASIC USES THE DOCK BANK 
FOR CARTRIDGE SOFTWARE 


When you power up the TS2068, part of the initialization involves testing the dock 

bank to see if a program is stored there. Programs fall into 2 broad categories. They 

can be either AROS (Application Rom Oriented Software) or LROS (Language Rom Oriented 
Software). Values in the first 8 bytes of the cartridge (addresses 32768 to 32775) 

define the cartridge and provide the computer with the information it needs to run it. 
These bytes correspond to the first 8 bytes of the ram board. 


By POKING these addresses with proper values, you can make the ram board take on the 
characteristics of a cartridge. The 8 bytes, sometimes called "ROS Overhead Bytes" are 
described below: 


start address 


BYTE HEX DECIMAL MEANING VALUE 
0 8000 32768 language type l=Basic & Machine Code 
2=Machine Code only 
l 8001 32769 cartridge type 1=LROS, 2=AROS 
2,3 8002 32770 start of program a two byte address 
4 8004 32772 chunk spec. binary value where "0" represents 


chunks used in the dock bank. "1" 
represents chunks used in home bank. 


5 8005 32773 autostart? O=No, 1=Yes. : 
6,7 8006 32774 # of bytes two byte value indicating the number 
reserved of bytes in the home bank reserved for 


machine code. (reserved area starts 
at 26688 decimal.) 


-10- 


For a typical Basic program to be stored in the dock bank, you could set the 8 bytes 
with the values below. In parentheses is the effect these values will have: POKE 
32768,1 (for BASIC); POKE 32769,2 (for AROS); POKE 32770,8 and POKE 32771,128 (for 
starting address of the Basic being at 008 hex--32776 dec.); POKE 32772,15 (a binary 
00001111 meaning chunks 4-7 in dock are used); POKE 32773,! (program will autostart); 
POKE 32774,0 and POKE 32775,0 (no storage space reserved--all of home bank will be 
available for Basic variables). 


Basic AROS programs stored in the Dock are run in an interesting way. immediately 
above the area reserved for machine code or data storage, is another area of memory 
called the AROS BUFFER, It starts with a length of 207 bytes, but it can expand and 
contract. When the computer finds a Basic program in the dock it runs it by bank 
switching to the chunks which hold the program {as defined by the "chunk spec" at 
address 32772). Next, it finds the line number it is to execute and transfers the line 
into the AROS BUFFER, adjusting the buffer size if necessary. The entire home bank is 
switched back in, and the program line in the buffer is executed. 


The Dock bank, therefore is used only as a storage medium for the Basic program. 
Variables used by the program are stored in the Home bank. Lines are pulled out of the 
Dock, inserted into the AROS BUFFER (which is in chunk 3 of the HOME bank) and 
executed from there. Dock Basic does not run exactly the same way that Home Basic 
does. Certain commands can present problems. User defined graphics will not work, nor 
will DEF FN and FN functions. GO TO and GOSUB commands which use expressions e.g. 
GOTO 1000*(4*(Y$="z")) work some of the time, but not always. This also applies to 
other commands which make heavy use of expression evaluation. The rule of the day 
regarding successful use of the dock bank is "keep it simple". The USR function which 
calls a machine code routine will determine the proper bank (dock or home) to select 

by the way you define the chunk spec byte in the AROS overhead. For example, if you 
use the recommended value of 15, you are indicating that chunks 4,5,6, and 7 are used 

in the dock bank. A user call will call the dock. If you set the chunk spec to a 

binary 10001111, you are indicating that chunks 4,5, and 6 are Dock while chunk 

7,0,1,2, and 3 are Home. If you RANDOMIZE USR 65000 (which is in chunk 7) the computer 
will execute the user call found in the home bank. Additionally, your machine code 

should not cross chunks. The computer enables only the chunk inwhich the user address 
resides. In contrast to the USR function, PEEK and POKE always refer to memory in the 
home bank. Bank switching, using the OUT 255 and OUT 244 commands cannot be 
accomplished by a cartridge type program. 


All tape commands (save, load, verify, and merge) act like POKE and PEEK in that they 
only work on memory in the HOME bank, This is true always--not just when you run a 
program from the dock. 


HOW TO STORE A BASIC PROGRAM 
IN THE DOCK BANK 


The computer, under most normal circumstances, sets the starting address of Basic 
programs to 26710 decimal. This presents a bit of a problem if you want to write or 

load a program into the dock because this is squarely in the middle of chunk three. A 
Basic program which is to be stored in the dock must start no lower than address 32776 
which is the 9th byte after the start of chunk 4. Bytes 1-8 remember, are used for the 
ROS overhead. Wouldn't it be nice if we could tell the computer to change its starting 
address for programs so they begin at 32776 instead of 26710? Fortunately, you can 

with a very short machine code program. Turn on your computer and enter the line 

show in listing 1. Then RUN it. 


= on : 


Listing 1. Routine to Move Prog. to 32776 


9oaoc RESTORE ae coe xeeoeee T 

O £23384: ab POKE NEXT 

* RANDOMIZE usr 23296- ‘BATA @33 
»,065,104,001.178,023,.195,.187.,.018 : 


This line moves the program area of memory up to address 32776. You should delete this 
line after it has run. It is important to note that the line does not do any bank 

switching for you. You'll still be in the Home bank after it has executed. Also, don't 
type NEW or you'll reset the program area to its lower address making it necessary to 
enter and run the line again. At this point you can begin entering a program directly 
from the keyboard or you can load one from cassette. Extremely long programs may need 
to be shortened before you load them. Since the program now starts at a higher 

address, you have about 6k less free memory to work with. Once you have your program 
_ thoroughly debugged, save a copy on tape. You may need it for more debugging later. 
Now you are ready to transfer the program into the Dock bank. This is done by adding 
the line below to your listing. 


Listing 2. Home to Dock Transfer Routine 


meee EEO TORE 9999: FOR x=23295 T 
a 23 EAD yy: POKE x,u: NEXT 
%: RANDOMIZE Use er oes ooo 


‘BBz 268 O7 a 235.1 75; 1211, 244 
ts 245 ,062.248,211,244,241,119 
11,935 ,229,8233,0008,000,.237,056 
2 1 O32 ,234,201 


By RUNNING 9999, you will copy your program over to the Dock. Be sure that before you 
do, the switches on the memory board are set so the Dock bank is selected and write 
protect is turned off. After the line is run, all that remains is to POKE the eight 

ROS overhead bytes with the proper values. Use those given previously to experiment 
with. 


When the final overhead byte is poked, execute the command OUT 244,0. Set the write 
protect switch to PR and turn off the computer. All you have to do to test your new 
cartridge program is turn the computer back on again. The program will come up running 
automatically if you poked the autostart overhead byte with a 1. If you poked it with 

a 0, type RUN and ENTER to start the program going. 


Remember that the computer at this point does not have any variables in memory so if 
your dock program tries to operate on a variable which has not been initialized by a 
program line, you will stop with an error. Undeclared variables must be loaded into 

the computer from tape. Save and Load commands should be incorporated into the dock 

' program to handle this. The action of these commands is the same as when you use them 
normally except that in the case of a program save, only the variables will go onto 

tape. Remember that cassette operations act only on the home bank. Since the program 
you have now exists only in the dock, there are no program lines to save--only 

variables. 


If your program does stop with an error, or if you intentionally BREAK, you won't be 


able to list the dock program nor can you add Basic program lines. Commands entered in 
the immediate mode (without a line number) will execute properly. That is why it is 
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important to save a copy of your program on to tape BEFORE you try it out in the dock 
bank. If a bug causes your basic to stop, you can use the tape version for debugging. 
New tries can then be transferred into the dock using the methods already detailed. 


Several Timex system variables exist which may be useful to you. They are: _ 


ARSBUF at 23748 and 23749 -a pointer to the AROS BUFFER 
ARSFLG at 23750 -bit 7 set indicates AROS is present. 
bits 0-6 are used by the computer when 
data is being placed in the home bank. 
ADATLN at 23751 and 23752 -a pointer to the current start of an AROS 
DATA line. 
ADLENG at 23753 and 23754 -stores the lenght of the current AROS DATA 
line. 


The ARSFLG (23750) is especially important. It acts as a switch to turn off the AROS 
program. If you POKE 23750,0 you can add and enter program lines into the home bank. 
RUN will cause the home bank program to execute. If you POKE 23750,128 the program in 
the dock is turned back on. You can no longer add program lines and the RUN command 
will pertain to the AROS program. 


A STEP-BY-STEP REAL EXAMPLE 


This experiment will demonstrate the steps required tc put a program in the dock bank. 
Follow each step in order, and to the letter. 


1. Plug the 32K memory into the computer. Set the memory for use in the DOCK, and 
the WR/PR should be set to "WR". Turn ON the computer and enter Listing 1. shown 
previously. 


2. Type RUN and ENTER. Then delete the program line. 
3. Enter the "demo" listing below. 


4 PRINT AT 9,3, "P.L.0. SOFTHA 
RE PRESENTS...": PRINT “FLIGHT P 
LAH FROM PALESTINE” 

S LET &=126: LET B=87: PLOT A 
E 


1@ LET X=1l4INT (RND+*13) 

2@ LET vYsl+iInT (‘RNG+1@: 

@e LET DL=si+INT (RNB#1a@) 

24 LET DPe=Ll+INT (RND#41@) 

26 IF 01¢6 THEN LET O1=-Dl1 

es IF Db2<6& THEN LET Oe=-fBe2 

3@ LET 0623={0137ABS D1) #xX: LET 6G 
#=iberAbs Dai xv 

60 IF €84+D1;255 OR A+D1<0 THEN 
LET Gi=-Bi 

70 IF B+De:175 OR B+D2<0 THEN 
LET Da=-Bbe 

65 LET AsA+Di: LET B=B+D2 

9@ DRAW D1,be 

180 60 TO 18 


4. Add the Home to Dock Transfer routine shown in listing 2 and execute the 
command RUN 9999. 


249s 


5. Now enter the following POKES: 


POKE 32768,1 
POKE 32769,2 
POKE 32770,8 
POKE 32771,128 
POKE 32772,BIN 00001111 
POKE 32773,1 
POKE 32774,0 
~ POKE: 32775,0 


6. Type: OUT 244,0 and press ENTER. Ignore any unusual efror reports. 


7. Flip the Write Protect Switch to PR. 
8. Turn OFF your computer, then turn it back ON, The program is now in the 
Dock bank and will come up running automatically! 


When the program is running, you can press BREAK to stop the program. You can enter 
commands in the immediate mode (such as PRINT A or PRINT X), but you cannot add any 
program lines or see a listing of the AROS program on the screen. However, if you POKE 
23750,0 you turn off the AROS. Now new lines can be entered but they will be 

considered a completely separate program by the computer. If you type RUN, this new 
program will run. If you POKE 23750,128 and then type RUN, you turn the AROS back on. 
Flight Plan will start running again. 


STORE A PROGRAM AND VARIABLES IN THE DOCK 


The previous section showed you how to STORE a program in the Dock bank and run it as 
if it were an Eprom cartridge. That method gives the advantages of having more memory 
for variables (which are stored in the Home bank). Cassette loading time is therefore 
reduced because memory used for program storage need not be loaded. Disadvantages are 
that you do not eliminate loading entirely, and some quirks of the operating system 

may mean you'll have to re-write portions of the Basic before it will work. 


An alternative method is to store not just program, but also variables in the dock 

bank. This eliminates saving and loading altogether. Operation is the same as if you 

were running completely in the home bank except you must restrict total size to the 

32K provided on the board. Using this technique is a little more cumbersome since you 
must. initialize the system manually and then GOTO a line number to start the program 
operating, but with this method, you CAN add or edit lines. The battery powered ram 
means that the program is always there. This saves a lot of time that you'd normally 
spend running your tape recorder. Periodic saves are stil! possible, of course, and I 
strongly recommend that you continue to make tape Pens You need to do it on a much 
less frequent basis, however. Me 


In addition, this method lets you run Basic from the EXROM bank if you wish. All you 
have to do is OUT 255,128 and flip the EXROM switch on the board. This eliminates 
potential conflicts with other devices which may give you memory in the Dock. It is 
the easiest way there is to make full use of the EXROM bank. 


To use this system, set the switches on the memory board to WR and DK. Insert the 


board into the cartridge slot and turn on the computer. Enter listing 4 shown below 
and RUN it. 
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Listing 4. 


1@ OUT 244,240: FOR x=32768 TO 
33909: READ y: POKE x,y: NEXT x 
OUT 244,90 

30 DATA 980,000,200, 2000,000,20 
, O82 , 802, 008 ,200,800,000,800,80 
' 802 , 800,000,000 ,800,000,202,00 
40 DATA 933,085,104,001;459,a2 
,295,187,018,017,085,104,333,e4 
7125 ,001,119,900,237,176,195,23 
°104,175,042,910,128,237,091,00 
1128, 237,082 ,940,080,055,213,¢04 


,235,205 ,187.018,@42,019,128.83 
,675,8692,225 ,.211,244,6017,255,25 
2205 ,138,104,126,205,138,104¢,11 
3,035,235 ,237,882 ,235 ,032,235,208 


68 DATA 245,219,244 ,238,240,21 
2244 ,241,201,295,133,184,842,88 
, 092,834,008 .125,229,042,075,89 
, 834,810,128 ,042 ,089,092,2034,01 
7128 ,062,240,225,205,117,104,@2 
,217,0642,083,092,@024,191 


FROMNOF FOU NOMS Cog 


After it stops, initialize the system using the immediate command: 


Initialize Command: 

OUT 244,248: RANDOMIZE USR 32790 
Now you can type in or load the program you wish to use. The program will be located 
in, and.will execute from the Home bank. To put it into the memory board, execute the 
command: 


Save program to the Dock Bank 

RANDOMIZE USR 26771 
A second or two is required for the transfer to complete itself. All memory from the 
start of the program to the top address 65535 will transfer. This means that even 
machine code or user defined graphics which are located above ramtop will save into 
the dock (or exrom) bank. 


This copying of the home bank into the dock bank is the equivalent of saving a program 
on tape. Instead of saving to a cassette, you are saving to battery backed memory. Any 
time you update your program, you also need to update the memory so adopt the practice 
of executing the RANDOMIZE USR 26771 command frequently. 


After memory is copied in this way, switch the write protect switch to PR and leave it 
there until you are ready to transfer your program again. 


Programs stored in this way will not come up running automatically. After turning on 


the computer, "load" the program from the memory board into the Home bank by executing 
the initialize command just given: OUT 244,240: RANDOMIZE USR 32790. 
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After a brief pause, the computer stops with a 0/ok report, afterwhich you can LIST 
the program, RUN it, or GO TO a specific line number. Remémber, always protect your 
program by leaving the write protect switch in the PR mode until just before you are 
ready to transfer data back into the extra memory. The write protect switch guards 
against glitches and run-away machine code which could ruin your program on the board 
by overwriting it. = 


After initialization, if a program is present in the NVM, it will appear on the 

screen when you type LIST. You can add, alter, and delete program lines in the usual 
manner. If you want to completely erase the program, do not use NEW as. this will 
reset the computer as well. Instead, use the command, DELETE 1,9999 followed by 
CLEAR. Every program line from 1 to 9999 will be erased as will al! your variables. 


CONCLUSION 


The instructions provided here cover orily a few of the many possible ways you can use 
your 32K Non-volatile Ram. Timex enthusiasts are only just beginning: to fully 

understand how to use additional banks of memory on their 2068s. Much more information 
about this topic will come as discoveries are made. You can read articles about banked 
memory expansion in SyncWare News, a bi-monthly journal on all things Timex, for 
$16.95 per year; and in Computer Updates (formerly Pro/File Updates) a quarterly, 
$12.95 per year. Subscriptions are available from Thomas B. Woods, P.O. Box 64, 
Jefferson, NH 03583. In addition, three individuals offer hardware and software for 

use with expansion memories. Write to them for more information. We suggest you - 
enclose $1 as a courtesy. 


Gesso Products, Bob Orrfelt, 3436 Bay Rd., Redwood City, CA 94063 
The John L. Oliger Co. 11601 Whidbey Dr. Cumberland, IN 46229 7 
Jack's Fairware, Jack Dohany, 325 O'Connor St., Menlo Park, CA 94025 
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